home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_zsh.idb / usr / freeware / catman / u_man / cat1 / zshbuiltins.Z / zshbuiltins
Encoding:
Text File  |  1998-05-21  |  64.8 KB  |  1,255 lines

  1.  
  2.  
  3.  
  4.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       zshbuiltins -    zsh built-in functions
  10.  
  11.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  12.       ---- _s_i_m_p_l_e _c_o_m_m_a_n_d
  13.            See the secion PPPPRRRREEEECCCCOOOOMMMMMMMMAAAANNNNDDDD MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS in _z_s_h_m_i_s_c(1).
  14.  
  15.       .... _f_i_l_e [ _a_r_g ... ]
  16.            Read commands from _f_i_l_e and execute them    in the current
  17.            shell environment.  If _f_i_l_e does    not contain a slash,
  18.            or if PPPPAAAATTTTHHHH____DDDDIIIIRRRRSSSS is set, the shell looks in the
  19.            components of ppppaaaatttthhhh to find the directory    containing
  20.            _f_i_l_e.  Files in the current directory are not read
  21.            unless "." appears somewhere in ppppaaaatttthhhh.  If any arguments
  22.            _a_r_g are given, they become the positional parameters;
  23.            the old positional parameters are restored when the
  24.            _f_i_l_e is done executing.    The exit status    is the exit
  25.            status of the last command executed.
  26.  
  27.       :::: [ _a_r_g ... ]
  28.            This command only expands parameters.  A    zero exit code
  29.            is returned.
  30.  
  31.       aaaalllliiiiaaaassss    [ -ggggmmmmrrrrLLLL    ] [ _n_a_m_e[=_v_a_l_u_e] ] ...
  32.            For each    _n_a_m_e with a corresponding _v_a_l_u_e, define    an
  33.            alias with that value.  A trailing space    in _v_a_l_u_e
  34.            causes the next word to be checked for alias
  35.            substitution.  If the -gggg    flag is    present, define    a
  36.            global alias; global aliases are    expanded even if they
  37.            do not occur in command position.  For each _n_a_m_e    with
  38.            no _v_a_l_u_e, print the value of _n_a_m_e, if any.  With    no
  39.            arguments, print    all currently defined aliases.    If the
  40.            -mmmm flag is given    the arguments are taken    as patterns
  41.            (they should be quoted to preserve them from being
  42.            interpreted as glob patterns) and the aliases matching
  43.            these patterns are printed.  When printing aliases and
  44.            the -gggg or -rrrr flags are present, then restrict the
  45.            printing    to global or regular aliases, respectively.
  46.            If the -LLLL flag is present, then print each alias    in a
  47.            manner suitable for putting in a    startup    script.     The
  48.            exit status is nonzero if a _n_a_m_e    (with no _v_a_l_u_e)    is
  49.            given for which no alias    has been defined.
  50.  
  51.       aaaauuuuttttoooollllooooaaaadddd [ _n_a_m_e ... ]
  52.            For each    of the _n_a_m_es (which are    names of functions),
  53.            create a    function marked    undefined.  The    ffffppppaaaatttthhhh variable
  54.            will be searched    to find    the actual function definition
  55.            when the    function is first referenced.  The definition
  56.            is contained in a file of the same name as the
  57.            function.  If the file found contains a standard
  58.            definition for the function, that is stored as the
  59.            function; otherwise, the    contents of the    entire file
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 4/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  71.  
  72.  
  73.  
  74.            are stored as the function.  The    latter format allows
  75.            functions to be used directly as    scripts.
  76.  
  77.       bbbbgggg [ _j_o_b ... ]
  78.       _j_o_b ... &&&&
  79.            Put each    specified _j_o_b in the background, or the
  80.            current job if none is specified.
  81.  
  82.       bbbbiiiinnnnddddkkkkeeeeyyyy -mmmmeeeevvvvdddd
  83.       bbbbiiiinnnnddddkkkkeeeeyyyy -rrrr _i_n-_s_t_r_i_n_g ...
  84.       bbbbiiiinnnnddddkkkkeeeeyyyy [ -aaaa ] _i_n-_s_t_r_i_n_g [ _c_o_m_m_a_n_d ] ...
  85.       bbbbiiiinnnnddddkkkkeeeeyyyy -ssss [ -aaaa ] _i_n-_s_t_r_i_n_g _o_u_t-_s_t_r_i_n_g ...
  86.            The -eeee and -vvvv options put the keymaps in    emacs mode or
  87.            vi mode respectively; they cannot be used
  88.            simultaneously. The -dddd option resets all    bindings to
  89.            the compiled-in settings. If not    used with options -eeee
  90.            or -vvvv, the maps will be left in emacs mode, or in vi
  91.            mode if the VVVVIIIISSSSUUUUAAAALLLL or EEEEDDDDIIIITTTTOOOORRRR variables exist and
  92.            contain the string "vi".     Metafied characters are bound
  93.            to self-insert by default. The -mmmm option    loads the
  94.            compiled-in bindings of these characters    for the    mode
  95.            determined by the preceding options, or the current
  96.            mode if used alone. Any previous    bindings done by the
  97.            user will be preserved. If the -rrrr option    is given,
  98.            remove any binding for each _i_n-_s_t_r_i_n_g. If the -ssss    option
  99.            is not specified, bind each _i_n-_s_t_r_i_n_g to    a specified
  100.            _c_o_m_m_a_n_d.    If no _c_o_m_m_a_n_d is specified, print the binding
  101.            of _i_n-_s_t_r_i_n_g if it is bound, or return a    nonzero    exit
  102.            code if it is not bound.    If the -ssss option is specified,
  103.            bind each _i_n-_s_t_r_i_n_g to each specified _o_u_t-_s_t_r_i_n_g. When
  104.            _i_n-_s_t_r_i_n_g is typed, _o_u_t-_s_t_r_i_n_g will be pushed back and
  105.            treated as input    to the line editor. This process is
  106.            recursive but, to avoid infinite    loops, the shell will
  107.            report an error if more than 20 consecutive
  108.            replacements happen. If the -aaaa option is    specified,
  109.            bind the    _i_n-_s_t_r_i_n_g_s in the alternative keymap instead
  110.            of the standard one.  The alternative keymap is used in
  111.            vi command mode.
  112.  
  113.            It's possible for an _i_n-_s_t_r_i_n_g to be bound to something
  114.            and also    be the beginning of a longer bound string. In
  115.            this case the shell will    wait a certain time to see if
  116.            more characters are typed and if    not it will execute
  117.            the binding. This timeout is defined by the KEYTIMEOUT
  118.            parameter; its default is 0.4 sec. No timeout is    done
  119.            if the prefix string is not bound.
  120.  
  121.            For either _i_n-_s_t_r_i_n_g or _o_u_t-_s_t_r_i_n_g, control characters
  122.            may be specified    in the form ^^^^XXXX,    and the    backslash may
  123.            be used to introduce one    of the following escape
  124.            sequences:
  125.             \\\\aaaa     bell character
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 4/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  137.  
  138.  
  139.  
  140.             \\\\nnnn     linefeed (newline)
  141.             \\\\bbbb     backspace
  142.             \\\\tttt     horizontal tab
  143.             \\\\vvvv     vertical tab
  144.             \\\\ffff     form feed
  145.             \\\\rrrr     carriage return
  146.             \\\\eeee,,,,    \\\\EEEE
  147.              escape
  148.             \\\\NNNNNNNNNNNN character code    in octal
  149.             \\\\xxxxNNNNNNNN character code    in hexadecimal
  150.             \\\\MMMM----xxxxxxxxxxxx
  151.              character or escape sequence with meta    bit
  152.              set. The `-' after the    `M' is optional.
  153.             \\\\CCCC----XXXX control character.  The `-' after the `C' is
  154.              optional.
  155.  
  156.            In all other cases, \ escapes the following character.
  157.            Delete is written as `^^^^????'. Note that `\M^?' and `^\M?'
  158.            are not the same.
  159.  
  160.            Multi-character _i_n-_s_t_r_i_n_gs cannot contain the null
  161.            character ("^@" or "^ "). If they appear    in a bindkey
  162.            command,    they will be silently translated to "\M-^@".
  163.            This restriction    does not apply to _o_u_t-_s_t_r_i_n_gs,
  164.            single-character    _i_n-_s_t_r_i_n_gs and the first character of
  165.            a multi-char _i_n-_s_t_r_i_n_g.
  166.  
  167.       bbbbrrrreeeeaaaakkkk    [ _n ]
  168.            Exit from an enclosing ffffoooorrrr, wwwwhhhhiiiilllleeee, uuuunnnnttttiiiillll, sssseeeelllleeeecccctttt, or
  169.            rrrreeeeppppeeeeaaaatttt loop.  If    _n is specified,    then break _n levels
  170.            instead of just one.
  171.  
  172.       bbbbuuuuiiiillllttttiiiinnnn _n_a_m_e [ _a_r_g_s ]    ...
  173.            Executes    the builtin _n_a_m_e, with the given _a_r_g_s.
  174.  
  175.       bbbbyyyyeeee  Same as eeeexxxxiiiitttt.
  176.  
  177.       ccccdddd [ _a_r_g ]
  178.       ccccdddd _o_l_d _n_e_w
  179.       ccccdddd +_nnnn
  180.            Change the current directory.  In the first form,
  181.            change the current directory to _a_r_g, or to the value of
  182.            HHHHOOOOMMMMEEEE if _a_r_g is not specified.  If _a_r_g is    -, change to
  183.            the value of OOOOLLLLDDDDPPPPWWWWDDDD, the    previous directory.  If    a
  184.            directory named _a_r_g is not found    in the current
  185.            directory and _a_r_g does not begin    with a slash, search
  186.            each component of the shell parameter ccccddddppppaaaatttthhhh.  If the
  187.            option CCCCDDDDAAAABBBBLLLLEEEEVVVVAAAARRRRSSSS is set, and a parameter named _a_r_g
  188.            exists whose value begins with a    slash, treat its value
  189.            as the directory.
  190.  
  191.            The second form of ccccdddd substitutes the string _n_e_w    for
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 4/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  203.  
  204.  
  205.  
  206.            the string _o_l_d in the name of the current directory,
  207.            and tries to change to this new directory.
  208.  
  209.            The third form of ccccdddd extracts an    entry from the
  210.            directory stack,    and changes to that directory.    An
  211.            argument    of the form +_n identifies a stack entry    by
  212.            counting    from the left of the list shown    by the ddddiiiirrrrssss
  213.            command,    starting with zero.  An    argument of the    form
  214.            -_n counts from the right.  If the PPPPUUUUSSSSHHHHDDDD____MMMMIIIINNNNUUUUSSSS option is
  215.            set, the    meanings of + and - in this context are
  216.            swapped.
  217.  
  218.       cccchhhhddddiiiirrrr
  219.            Same as ccccdddd.
  220.  
  221.       ccccoooommmmmmmmaaaannnndddd _s_i_m_p_l_e _c_o_m_m_a_n_d
  222.            See the secion PPPPRRRREEEECCCCOOOOMMMMMMMMAAAANNNNDDDD MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS in _z_s_h_m_i_s_c(1).
  223.  
  224.       ccccoooommmmppppccccttttllll
  225.            Compctl has it's    own man    page.  Check _z_s_h_c_o_m_p_c_t_l(1).
  226.  
  227.       ccccoooonnnnttttiiiinnnnuuuueeee [ _n_u_m ]
  228.            Resume the next iteration of the    enclosing ffffoooorrrr, wwwwhhhhiiiilllleeee,
  229.            uuuunnnnttttiiiillll, sssseeeelllleeeecccctttt, or rrrreeeeppppeeeeaaaatttt    loop.  If _n is specified,
  230.            break out of _n -    1 loops    and resume at the _nth
  231.            enclosing loop.
  232.  
  233.       ddddeeeeccccllllaaaarrrreeee [ _a_r_g    ... ]
  234.            Same as ttttyyyyppppeeeesssseeeetttt.
  235.  
  236.       ddddiiiirrrrssss [ -vvvv ] [    _a_r_g ...    ]
  237.            With no arguments, print    the contents of    the directory
  238.            stack.  If the -vvvv option    is given, number the
  239.            directories in the stack    when printing.    Directories
  240.            are added to this stack with the    ppppuuuusssshhhhdddd command, and
  241.            removed with the    ccccdddd or ppppooooppppdddd commands.  If arguments are
  242.            specified, load them onto the directory stack,
  243.            replacing anything that was there, and push the current
  244.            directory onto the stack.
  245.  
  246.       ddddiiiissssaaaabbbblllleeee [ -aaaaffffmmmmrrrr ] _a_r_g    ...
  247.            Disable the hash    table element named _a_r_g    temporarily.
  248.            The default is to disable builtin commands.  This
  249.            allows you to use an external command with the same
  250.            name as a builtin command.  The -aaaa option causes
  251.            ddddiiiissssaaaabbbblllleeee to act on aliases.  The -ffff option causes
  252.            ddddiiiissssaaaabbbblllleeee to act on shell functions.  The -rrrr options
  253.            causes ddddiiiissssaaaabbbblllleeee to act on    reserved words.     Without
  254.            arguments all disabled hash table elements from the
  255.            corresponding hash table    are printed.  With the -mmmm flag
  256.            the arguments are taken as patterns (should be quoted
  257.            to preserve them    from being taken as glob patterns) and
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 4/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  269.  
  270.  
  271.  
  272.            all hash    table elements from the    corresponding hash
  273.            table matching these patterns are disabled.  Disabled
  274.            objects can be enabled with the eeeennnnaaaabbbblllleeee command.
  275.  
  276.       ddddiiiissssoooowwwwnnnn [ _j_o_b ... ]
  277.       _j_o_b ... &&&&||||
  278.       _j_o_b ... &&&&!!!!
  279.            Remove the specified jobs from the job table; the shell
  280.            will no longer report their status, and will not
  281.            complain    if you try to exit an interactive shell    with
  282.            them running or stopped.     If no _j_o_b is specified, use
  283.            the current job.
  284.  
  285.       eeeecccchhhhoooo [ -nnnneeeeEEEE ]    [ _a_r_g ... ]
  286.            Write each _a_r_g on the standard output, with a space
  287.            separating each one.  If    the -nnnn flag is not present,
  288.            print a newline at the end.  eeeecccchhhhoooo recognizes the
  289.            following escape    sequences:
  290.            \\\\aaaa   bell character
  291.            \\\\bbbb   backspace
  292.            \\\\cccc   don't print    an ending newline
  293.            \\\\eeee   escape
  294.            \\\\ffff   form feed
  295.            \\\\nnnn   newline
  296.            \\\\rrrr   carriage return
  297.            \\\\tttt   horizontal tab
  298.            \\\\vvvv   vertical tab
  299.            \\\\\\\\   backslash
  300.            \\\\0000NNNNNNNNNNNN
  301.             character code in octal, with a maximum of three
  302.             digits after the zero; a non-octal digit
  303.             terminates the number
  304.            \\\\xxxxNNNNNNNN character code in hexadecimal, with    a maximum of
  305.             two    digits after the `x'; a    non-hexadecimal    digit
  306.             terminates the number.
  307.  
  308.            The -EEEE falg or the BBBBSSSSDDDD____EEEECCCCHHHHOOOO option can be used to
  309.            disable these escape sequences. In the later case -eeee
  310.            flag can    be used    to enable them.
  311.  
  312.       eeeecccchhhhoooottttcccc _c_a_p [ _a_r_g ... ]
  313.            Output the termcap string corresponding to the
  314.            capability _c_a_p, with optional arguments.
  315.  
  316.       eeeemmmmuuuullllaaaatttteeee [ -RRRR ] [ zzzzsssshhhh | sssshhhh | kkkksssshhhh | ccccsssshhhh    ]
  317.            Set up zsh options to emulate the specified shell as
  318.            much as possible.  ccccsssshhhh will never be fully emulated.
  319.            If the argument is not one of the shells    listed above,
  320.            zzzzsssshhhh will    be used    as a default.  If the -RRRR option    is
  321.            given, all options are reset to their default value
  322.            corresponding to    the specified emulation    mode.
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 4/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  335.  
  336.  
  337.  
  338.       eeeennnnaaaabbbblllleeee [ -aaaaffffmmmmrrrr ] _a_r_g ...
  339.            Enable the hash table element named _a_r_g,    presumably
  340.            disabled    earlier    with ddddiiiissssaaaabbbblllleeee.  The default is to
  341.            enable builtin commands.     The -aaaa    option causes eeeennnnaaaabbbblllleeee
  342.            to act on aliases.  The -ffff option causes    eeeennnnaaaabbbblllleeee to act
  343.            on shell    functions.  The    -rrrr option causes eeeennnnaaaabbbblllleeee    to act
  344.            on reserved words.  Without arguments all enable    hash
  345.            table elememts from the corresponding hash table    are
  346.            printed.     With the -mmmm flag the arguments    are taken as
  347.            patterns    (should    be quoted) and all hash    table elements
  348.            from the    corresponding hash table matching these
  349.            patterns    are enabled.  Enabled objects can be disabled
  350.            with the    ddddiiiissssaaaabbbblllleeee    builtin    command.
  351.  
  352.       eeeevvvvaaaallll [ _a_r_g ... ]
  353.            Read the    arguments as input to the shell    and execute
  354.            the resulting command(s)    in the current shell process.
  355.  
  356.       eeeexxxxeeeecccc _s_i_m_p_l_e _c_o_m_m_a_n_d
  357.            See the secion PPPPRRRREEEECCCCOOOOMMMMMMMMAAAANNNNDDDD MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS in _z_s_h_m_i_s_c(1).
  358.  
  359.       eeeexxxxiiiitttt [ _n ]
  360.            Exit the    shell with the exit code specified by _n; if
  361.            none is specified, use the exit code from the last
  362.            command executed.  An EOF condition will    also cause the
  363.            shell to    exit, unless the IIIIGGGGNNNNOOOORRRREEEEEEEEOOOOFFFF option is set.
  364.  
  365.       eeeexxxxppppoooorrrrtttt [ _n_a_m_e[=_v_a_l_u_e]    ... ]
  366.            The specified _n_a_m_es are marked for automatic export to
  367.            the environment of subsequently executed    commands.
  368.            eeeexxxxppppoooorrrrtttt is equivalent to ttttyyyyppppeeeesssseeeetttt ----xxxx.
  369.  
  370.       ffffaaaallllsssseeee
  371.            Do nothing and return an    exit code of 1.
  372.  
  373.       ffffcccc [ -eeee _e_n_a_m_e    ] [ -
  374.            nnnnllllrrrrddddDDDDffffEEEEiiiimmmm ] [ _o_l_d=_n_e_w ... ] [ _f_i_r_s_t [ _l_a_s_t ] ]
  375.       ffffcccc -AAAARRRRWWWWIIII [ _f_i_l_e_n_a_m_e ]
  376.            Select a    range of commands from _f_i_r_s_t to    _l_a_s_t from the
  377.            history list.  The arguments _f_i_r_s_t and _l_a_s_t may be
  378.            specified as a number or    as a string.  A    negative
  379.            number is used as an offset to the current history
  380.            event number.  A    string specifies the most recent event
  381.            beginning with the given    string.     All substitutions
  382.            _o_l_d=_n_e_w,    if any,    are then performed on the commands.
  383.            If the -llll flag is given,    the resulting commands are
  384.            listed on standard output.  If the -mmmm flag is also
  385.            given the first argument    is taken as a pattern (should
  386.            be quoted) and only the history events matching this
  387.            pattern will be shown.  Otherwise the editor program
  388.            _e_n_a_m_e is    invoked    on a file containing these history
  389.            events.    If _e_n_a_m_e is not    given, the value of the
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 4/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  401.  
  402.  
  403.  
  404.            parameter FFFFCCCCEEEEDDDDIIIITTTT    is used.  If _e_n_a_m_e is "-", no editor
  405.            is invoked.  When editing is complete, the edited
  406.            command(s) is executed. If _f_i_r_s_t    is not specified, it
  407.            will be set to -1 (the most recent event), or to    -16 if
  408.            the -llll flag is given.  If _l_a_s_t is not specified,    it
  409.            will be set to _f_i_r_s_t, or    to -1 if the -llll    flag is    given.
  410.            The flag    -rrrr reverses the    order of the commands and the
  411.            flag -nnnn suppresses command numbers when listing.     Also
  412.            when listing, -dddd    prints timestamps for each command,
  413.            and -ffff prints full time-date stamps. Adding the -EEEE flag
  414.            causes the dates    to be printed as `dd.mm.yyyy', instead
  415.            of the default `mm/dd/yyyy'.  Adding the    -iiii flag    causes
  416.            the dates to be printed as `yyyy-mm-dd',    in a fixed
  417.            format.    With the -DDDD flag, ffffcccc prints elapsed times.
  418.  
  419.            ffffcccc -RRRR reads the history from the    given file, ffffcccc -WWWW
  420.            writes the history out to the given file, and ffffcccc    -AAAA
  421.            appends the history out to the given file.  ffffcccc -AAAAIIII
  422.            (-WWWWIIII) appends (writes) only those events    that are new
  423.            since last incremental append (write) to    the history
  424.            file. In    any case the file will have no more than
  425.            SAVEHIST    entries.
  426.  
  427.       ffffgggg [ _j_o_b ... ]
  428.       _j_o_b ...
  429.            Bring the specified _j_o_bs    to the foreground.  If no _j_o_b
  430.            is specified, use the current job.
  431.  
  432.       ffffuuuunnnnccccttttiiiioooonnnnssss [ +_ttttuuuummmm ] [ _n_a_m_e ...    ]
  433.            Equivalent to ttttyyyyppppeeeesssseeeetttt ----ffff.
  434.  
  435.       ggggeeeettttllllnnnn    _n_a_m_e ...
  436.            Read the    top value from the buffer stack    and put    it in
  437.            the shell parameter _n_a_m_e.  Equivalent to    rrrreeeeaaaadddd -zzzzrrrr. The
  438.            flags -cccc, -llll, -AAAA, -eeee, -EEEE, and -nnnn    are supported, too.
  439.  
  440.       ggggeeeettttooooppppttttssss _o_p_t_s_t_r_i_n_g _n_a_m_e [ _a_r_g ... ]
  441.            Checks aaaarrrrgggg for legal options.  If _a_r_g is    omitted, use
  442.            the positional parameters.  A valid option argument
  443.            begins with a + or a -.    An argument not    beginning with
  444.            a + or a    -, or the argument --, ends the    options.
  445.            _o_p_t_s_t_r_i_n_g contains the letters that ggggeeeettttooooppppttttssss recognizes.
  446.            If a letter is followed by a `:', that option is
  447.            expected    to have    an argument.  The options can be
  448.            separated from the argument by blanks.
  449.  
  450.            Each time it is invoked,    ggggeeeettttooooppppttttssss    places the option
  451.            letter it finds in the shell parameter _n_a_m_e, prepended
  452.            with a +    when _a_r_g begins    with a +.  The index of    the
  453.            next _a_r_g    is stored in OOOOPPPPTTTTIIIINNNNDDDD.  The option argument, if
  454.            any, is stored in OOOOPPPPTTTTAAAARRRRGGGG.
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 4/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  467.  
  468.  
  469.  
  470.            A leading : in _o_p_t_s_t_r_i_n_g    causes ggggeeeettttooooppppttttssss to store    the
  471.            letter of the invalid option in OOOOPPPPTTTTAAAARRRRGGGG, and to set _n_a_m_e
  472.            to `?' for an unknown option and    to `:' when a required
  473.            option is missing.  Otherwise, ggggeeeettttooooppppttttssss prints an    error
  474.            message.     The exit status is nonzero when there are no
  475.            more options.
  476.  
  477.       hhhhaaaasssshhhh [ -ddddffffmmmmrrrr ] [ _n_a_m_e[=_v_a_l_u_e]    ] ...
  478.            With no arguments or options, hhhhaaaasssshhhh will list the    entire
  479.            command hash table.
  480.  
  481.            The -mmmm option causes the    arguments to be    taken as
  482.            patterns    (they should be    quoted)    and the    elements of
  483.            the command hash    table matching these patterns are
  484.            printed.
  485.  
  486.            The -rrrr option causes the    command    hash table to be
  487.            thrown out and restarted.  The -ffff option    causes the
  488.            entire path to be searched, and all the commands    found
  489.            are added to the    hash table.  These options cannot be
  490.            used with any arguments.
  491.  
  492.            For each    _n_a_m_e with a corresponding _v_a_l_u_e, put _n_a_m_e in
  493.            the command hash    table, associating it with the
  494.            pathname    _v_a_l_u_e.    Whenever _n_a_m_e is used as a command
  495.            argument, the shell will    try to execute the file    given
  496.            by _v_a_l_u_e.  For each _n_a_m_e    with no    corresponding _v_a_l_u_e,
  497.            search for _n_a_m_e in the path, and    add it to the command
  498.            hash table, and associating it with the discovered
  499.            path, if    it is found.
  500.  
  501.            Adding the -dddd option causes hhhhaaaasssshhhh    to act on the named
  502.            directory table instead of the command hash table.  The
  503.            remaing discussion of hhhhaaaasssshhhh will assume that the -dddd is
  504.            given.
  505.  
  506.            If invoked without any arguments, and without any other
  507.            options,    hhhhaaaasssshhhh ----dddd    lists the entire named directory
  508.            table.
  509.  
  510.            The -mmmm option causes the    arguments to be    taken as
  511.            patterns    (they should be    quoted)    and the    elements of
  512.            the named directory table matching these    patterns are
  513.            printed.
  514.  
  515.            The -rrrr option causes the    named directory    table to be
  516.            thrown out and restarted    so that    it only    contains `~'.
  517.            The -ffff option causes all    usernames to be    added to the
  518.            named directory table.  There options cannot be used
  519.            with any    arguments.
  520.  
  521.            For each    _n_a_m_e with a corresponding _v_a_l_u_e, put _n_a_m_e in
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 4/24/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  533.  
  534.  
  535.  
  536.            the named directory table.  The directory name _n_a_m_e is
  537.            then associated with the    specified path _v_a_l_u_e, so that
  538.            _v_a_l_u_e may be referred to    as `~_n_a_m_e'.  For each _n_a_m_e
  539.            with no corresponding _v_a_l_u_e, search for as a username
  540.            and as a    parameter.  If it is found, it is added    to the
  541.            named directory hash table.
  542.  
  543.       hhhhiiiissssttttoooorrrryyyy [ -nnnnrrrrddddDDDDffffEEEEiiiimmmm ]    [ _f_i_r_s_t    [ _l_a_s_t ] ]
  544.            Same as ffffcccc -llll.
  545.  
  546.       iiiinnnntttteeeeggggeeeerrrr [ +_llllrrrrttttuuuuxxxx ] [ _n_a_m_e[=_v_a_l_u_e] ] ...
  547.            Same as ttttyyyyppppeeeesssseeeetttt -iiii, except that options irrelevant to
  548.            integers    are not    permitted.
  549.  
  550.       jjjjoooobbbbssss [ -llllpppprrrrssss ] [ _j_o_b ... ]
  551.            Lists information about each given job, or all jobs if
  552.            _j_o_b is omitted.    The -llll flag lists process ids, and the
  553.            -pppp flag lists process groups.  If the -rrrr    flag is
  554.            specified only running jobs will    be listed and if the
  555.            -ssss flag is given    only stopped jobs are shown.
  556.  
  557.       kkkkiiiillllllll [ -ssss _s_i_g_n_a_l__n_a_m_e    ] _j_o_b ...
  558.       kkkkiiiillllllll [ -_s_i_g ]    _j_o_b ...
  559.       kkkkiiiillllllll -llll [ _s_i_g    ... ]
  560.            Sends either SIGTERM or the specified signal to the
  561.            given jobs or processes.     Signals are given by number
  562.            or by names, without the    SIG prefix.  If    the signal
  563.            being sent is not KILL or CONT, then the    job will be
  564.            sent a CONT signal if it    is stopped.  The argument _j_o_b
  565.            can be the process id of    a job not in the job list.  In
  566.            the third form, kkkkiiiillllllll -llll,    if _s_i_g is not specified    the
  567.            signal names are    listed.     Otherwise, for    each _s_i_g that
  568.            is a name, the corresponding signal number is listed.
  569.            For each    _s_i_g that is a signal number or a number
  570.            representing the    exit status of a process which was
  571.            terminated or stopped by    a signal the name of the
  572.            signal is printed.
  573.  
  574.       lllleeeetttt _a_r_g ...
  575.            Evaluate    each _a_r_g as an arithmetic expression.  See
  576.            AAAARRRRIIIITTTTHHHHMMMMEEEETTTTIIIICCCC EEEEVVVVAAAALLLLUUUUAAAATTTTIIIIOOOONNNN above for a description of
  577.            arithmetic expressions.    The exit status    is 0 if    the
  578.            value of    the last expression is nonzero,    and 1
  579.            otherwise.
  580.  
  581.       lllliiiimmmmiiiitttt    [ -hhhhssss ]    [ _r_e_s_o_u_r_c_e [ _l_i_m_i_t ] ] ...
  582.            Set or display resource limits.    Unless the -ssss flag is
  583.            given the limit applies only the    children of the    shell.
  584.            If -ssss is    given without other arguments, the resource
  585.            limits of the current shell is set to the previously
  586.            set resource limits of the children.  If    _l_i_m_i_t is not
  587.            specified, print    the current limit placed on _r_e_s_o_u_r_c_e;
  588.  
  589.  
  590.  
  591.      Page 9                         (printed 4/24/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  599.  
  600.  
  601.  
  602.            otherwise set the limit to the specified    value.    If the
  603.            -hhhh flag is given, use hard limits instead of soft
  604.            limits.    If no _r_e_s_o_u_r_c_e is given, print all limits.
  605.  
  606.            _r_e_s_o_u_r_c_e    is one of:
  607.  
  608.            ccccppppuuuuttttiiiimmmmeeee
  609.             Maximum CPU    seconds    per process.
  610.            ffffiiiilllleeeessssiiiizzzzeeee
  611.             Largest single file    allowed.
  612.            ddddaaaattttaaaassssiiiizzzzeeee
  613.             Maximum data size (including stack)    for each
  614.             process.
  615.            ssssttttaaaacccckkkkssssiiiizzzzeeee
  616.             Maximum stack size for each    process.
  617.            ccccoooorrrreeeedddduuuummmmppppssssiiiizzzzeeee
  618.             Maximum size of a core dump.
  619.            rrrreeeessssiiiiddddeeeennnntttt
  620.             Maximum resident set size.
  621.            mmmmeeeemmmmoooorrrryyyyuuuusssseeee
  622.             The    same as    resident.
  623.            mmmmeeeemmmmoooorrrryyyylllloooocccckkkkeeeedddd
  624.             Maximum amount of memory locked in RAM.
  625.            ddddeeeessssccccrrrriiiippppttttoooorrrrssss
  626.             Maximum value for a    file descriptor.
  627.            ooooppppeeeennnnffffiiiilllleeeessss
  628.             Maximum number of open files.
  629.            vvvvmmmmeeeemmmmoooorrrryyyyssssiiiizzzzeeee
  630.             Maximum amount of virtual memory.
  631.  
  632.            Which of    these resource limits are available depends on
  633.            the system.  _l_i_m_i_t is a number, with an optional
  634.            scaling factor, as follows:
  635.  
  636.            _nh   hours.
  637.            _nk   kilobytes. This is the default for all but
  638.             cputime.
  639.            _nm   megabytes or minutes.
  640.            _m_m:_s_s
  641.             minutes and    seconds.
  642.  
  643.       llllooooccccaaaallll    [ +_LLLLRRRRZZZZiiiillllrrrrttttuuuu [[[[_n]]]]]]]] [[[[ _n_a_m_e[[[[====_v_a_l_u_e]]]]    ]]]] ............
  644.            Same as ttttyyyyppppeeeesssseeeetttt,    except that the    options    -xxxx and -ffff are
  645.            not permitted.
  646.  
  647.       lllloooogggg  List all    users currently    logged in who are affected by
  648.            the current setting of the wwwwaaaattttcccchhhh    parameter.
  649.  
  650.       llllooooggggoooouuuutttt
  651.            Exit the    shell, if this is a login shell.
  652.  
  653.       nnnnoooogggglllloooobbbb _s_i_m_p_l_e    _c_o_m_m_a_n_d
  654.  
  655.  
  656.  
  657.      Page 10                         (printed 4/24/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  665.  
  666.  
  667.  
  668.            See the secion PPPPRRRREEEECCCCOOOOMMMMMMMMAAAANNNNDDDD MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS in _z_s_h_m_i_s_c(1).
  669.  
  670.       ppppooooppppdddd [ +__n ]
  671.            Removes a entry from the    directory stack, and perform a
  672.            ccccdddd to the new top directory. With no argument, the
  673.            current top entry is removed.  An argument of the form
  674.            +_n identifies a stack entry by counting from the    left
  675.            of the list shown by the    ddddiiiirrrrssss command, starting with
  676.            zero.  An argument of the form -_n counts    from the
  677.            right.  If the PPPPUUUUSSSSHHHHDDDD____MMMMIIIINNNNUUUUSSSS option is set, the meanings
  678.            of + and    - in this context are swapped.
  679.  
  680.       pppprrrriiiinnnntttt    [ -nnnnrrrrssssllllzzzzppppNNNNDDDDPPPPooooOOOOiiiiccccmmmm ] [ -uuuu_n ] [ -RRRR [ -eeeennnn ]] [ _a_r_g    ... ]
  681.            With no flags or    with flag -, the arguments are printed
  682.            on the standard output as described by eeeecccchhhhoooo, with the
  683.            following differences:  the escape sequence \M-x
  684.            metafies    the character xxxx    (sets the highest bit),    \C-x
  685.            produces    a control character (\C-@ and \C-? give    the
  686.            characters NULL and delete) and \E is a synonym for \e.
  687.            Finally,    if not in an escape sequence, \    escapes    the
  688.            following character and is not printed.
  689.            -rrrr   ignore the escape conventions of eeeecccchhhhoooo.
  690.            -RRRR   emulate the    BSD eeeecccchhhhoooo command which does not
  691.             process escape sequences unless the    -eeee flag    is
  692.             given. The -nnnn flag suppresses the trailing
  693.             newline. Only the -eeee and -nnnn    flags are recognized
  694.             after -RRRR, all other    arguments and options are
  695.             printed.
  696.            -mmmm   Take the fist argument as a    pattern    (should    be
  697.             quoted) and    remove it from the argument list
  698.             together with subsequent arguments that do not
  699.             match this pattern.
  700.            -ssss   place the results in the history list instead of
  701.             on the standard output.
  702.            -nnnn   do not add a newline to the    output.
  703.            -llll   print the arguments    separated by newlines instead
  704.             of spaces.
  705.            -NNNN   print the arguments    separated and terminated by
  706.             nulls.
  707.            -oooo   print the arguments    sorted in ascending order.
  708.            -OOOO   print the arguments    sorted in descending order.
  709.            -iiii   if given together with -oooo or -OOOO makes them work
  710.             case independently
  711.            -cccc   print the arguments    in columns
  712.            -uuuu_n  print the arguments    to file    descriptor _n.
  713.            -pppp   print the arguments    to the input of    the coprocess.
  714.            -zzzz   push the arguments onto the    editing    buffer stack,
  715.             separated by spaces; no escape sequences are
  716.             recognized.
  717.            -DDDD   treat the arguments    as directory names, replacing
  718.             prefixes with ~ expressions, as appropriate.
  719.            -PPPP   recognize the same escape sequences    as in the
  720.  
  721.  
  722.  
  723.      Page 11                         (printed 4/24/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  731.  
  732.  
  733.  
  734.             PPPPRRRROOOOMMMMPPPPTTTT parameter.
  735.  
  736.       ppppuuuusssshhhhdddd    [ _a_r_g ]
  737.       ppppuuuusssshhhhdddd    _o_l_d _n_e_w
  738.       ppppuuuusssshhhhdddd    +_nnnn
  739.            Change the current directory, and push the old current
  740.            directory onto the directory stack.  In the first form,
  741.            change the current directory to _a_r_g.  If    _a_r_g is not
  742.            specified, change to the    second directory on the    stack
  743.            (that is, exchange the top two entries),    or change to
  744.            the value of HHHHOOOOMMMMEEEE if the    PPPPUUUUSSSSHHHHDDDD____TTTTOOOO____HHHHOOOOMMMMEEEE option is    set or
  745.            if there    is only    one entry on the stack.     If _a_r_g    is -,
  746.            change to the value of OOOOLLLLDDDDPPPPWWWWDDDD, the previous directory.
  747.            If a directory named _a_r_g    is not found in    the current
  748.            directory and _a_r_g does not contain a slash, search each
  749.            component of the    shell parameter    ccccddddppppaaaatttthhhh.     If the    option
  750.            CCCCDDDDAAAABBBBLLLLEEEEVVVVAAAARRRRSSSS is set, and a    parameter named    _a_r_g exists
  751.            whose value begins with a slash,    treat its value    as the
  752.            directory.  If the option PPPPUUUUSSSSHHHHDDDD____SSSSIIIILLLLEEEENNNNTTTT is not set, the
  753.            directory stack will be printed after a ppppuuuusssshhhhdddd is
  754.            performed.
  755.  
  756.            The second form of ppppuuuusssshhhhdddd    substitutes the    string _n_e_w for
  757.            the string _o_l_d in the name of the current directory,
  758.            and tries to change to this new directory.
  759.  
  760.            The third form of ppppuuuusssshhhhdddd changes directory by rotating
  761.            the directory list.  An argument    of the form +_n
  762.            identifies a stack entry    by counting from the left of
  763.            the list    shown by the ddddiiiirrrrssss command, starting with zero.
  764.            An argument of the form -_n counts from the right.  If
  765.            the PPPPUUUUSSSSHHHHDDDD____MMMMIIIINNNNUUUUSSSS option is set, the meanings of +    and -
  766.            in this context are swapped.
  767.  
  768.       ppppuuuusssshhhhllllnnnn
  769.            Equivalent to pppprrrriiiinnnntttt ----nnnnzzzz.
  770.  
  771.       ppppwwwwdddd [    -rrrr ]
  772.            Print the absolute pathname of the current working
  773.            directory.  If the -rrrr flag is specified or the
  774.            CCCCHHHHAAAASSSSEEEE____LLLLIIIINNNNKKKKSSSS option is set, the printed path will    not
  775.            contain symbolic    links.
  776.  
  777.       rrrr    Equivalent to ffffcccc    ----eeee ----.
  778.  
  779.       rrrreeeeaaaadddd [ -rrrrzzzzppppqqqqAAAAccccllllnnnneeeeEEEE ] [ -k [ _n_u_m ] ]
  780.            [ -uuuu_n ] [ _n_a_m_e?_p_r_o_m_p_t ] [ _n_a_m_e ...  ]
  781.  
  782.            Read one    line and break it into fields using the
  783.            characters in IIIIFFFFSSSS as separators.
  784.            ----rrrr   Raw    mode: a    \ at the end of    a line does not
  785.             signify line continuation.
  786.  
  787.  
  788.  
  789.      Page 12                         (printed 4/24/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  797.  
  798.  
  799.  
  800.            -qqqq   Read only one character from the terminal and set
  801.             _n_a_m_e to `y'    if this    character was `y' or `Y' and
  802.             to `n' otherwise.  With this flag set the return
  803.             value is zero only if the character    was `y'    or
  804.             `Y'.
  805.            -kkkk [ _n_u_m    ]
  806.             Read only one (or _n_u_m) characters from the
  807.             terminal.
  808.            -zzzz   Read from the editor buffer    stack.    The first
  809.             field is assigned to the first _n_a_m_e, the second
  810.             field to the second    _n_a_m_e, etc., with leftover
  811.             fields assigned to the last    _n_a_m_e.
  812.            -eeee
  813.            -EEEE   The    words read are printed after the whole line is
  814.             read. If the -eeee flag is set, the words are not
  815.             assigned to    the parameters.
  816.            -AAAA   The    first _n_a_m_e is taken as the name    of an array
  817.             and    all words are assigned to it.
  818.            -cccc
  819.            -llll   These flags    are allowed only if called inside a
  820.             function used for completion (specified with the
  821.             -KKKK flag to ccccoooommmmppppccccttttllll). If the    -cccc flag    is given, the
  822.             words of the current command are read. If the -llll
  823.             flag is given, the whole line is assigned as a
  824.             scalar.  If    _n_a_m_e is    omitted    then RRRREEEEPPPPLLLLYYYY is used for
  825.             scalars and    rrrreeeeppppllllyyyy for arrays.
  826.            -nnnn   Together with either of the    previous flags,    this
  827.             option gives the number of the word    the cursor is
  828.             on or the index of the character the cursor    is on
  829.             respectively.
  830.            -uuuu_n  Input is read from file descriptor _n.
  831.            -pppp   Input is read from the coprocess.
  832.  
  833.            If the first argument contains a    ????, the remainder of
  834.            this word is used as a _p_r_o_m_p_t on    standard error when
  835.            the shell is interactive.  The exit status is 0 unless
  836.            an end-of-file is encountered.
  837.  
  838.       rrrreeeeaaaaddddoooonnnnllllyyyy [ _n_a_m_e[=_v_a_l_u_e] ] ...
  839.            The given _n_a_m_e_s are marked readonly; these names    cannot
  840.            be changed by subsequent    assignment.
  841.  
  842.       rrrreeeehhhhaaaasssshhhh [ -ddddffff ]
  843.            Throw out the command hash table    and start over.     If
  844.            the -ffff option is    set, rescan the    command    path
  845.            immediately, instead of rebuilding the hash table
  846.            incrementally.
  847.  
  848.            The -dddd option causes rrrreeeehhhhaaaasssshhhh to act on the named
  849.            directory table instead of the command hash table.
  850.            This reduces the    named directory    table to only the `~'
  851.            entry.  If the -ffff option    is also    used, the named
  852.  
  853.  
  854.  
  855.      Page 13                         (printed 4/24/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  863.  
  864.  
  865.  
  866.            directory table is rebuilt immediately.
  867.  
  868.            rrrreeeehhhhaaaasssshhhh is equivalent to hhhhaaaasssshhhh -rrrr.
  869.  
  870.       rrrreeeettttuuuurrrrnnnn [ _n ]
  871.            Causes a    shell function or .... script to return to    the
  872.            invoking    script with the    return status specified    by _n.
  873.            If _n is omitted then the    return status is that of the
  874.            last command executed.
  875.  
  876.            If rrrreeeettttuuuurrrrnnnn was executed from a trap in a TTTTRRRRAAAAPPPPxxxxxxxxxxxx
  877.            function, the effect is different for zero and non-zero
  878.            return status.  With zero status    (or after an implicit
  879.            return at the end of the    trap), the shell will return
  880.            to whatever it was previously processing; with a    non-
  881.            zero status, the    shell will behave as interrupted
  882.            except that the return status of    the trap is retained.
  883.            Note that the signal which caused the trap is passed as
  884.            the first argument, so the statement `rrrreeeettttuuuurrrrnnnn
  885.            $$$$((((((((111122228888++++$$$$1111))))))))' will return    the same status    as if the
  886.            signal had not been trapped.
  887.  
  888.       sssscccchhhheeeedddd    [+]_h_h:_m_m _c_o_m_m_a_n_d ...
  889.       sssscccchhhheeeedddd    [ -_i_t_e_m    ]
  890.            Make an entry in    the scheduled list of commands to
  891.            execute.     The time may be specified in either absolute
  892.            or relative time.  With no arguments, prints the    list
  893.            of scheduled commands.  With the    argument -_i_t_e_m,
  894.            removes the given item from the list.
  895.  
  896.      ]
  897.       sssseeeetttt [    +__o_p_t_i_o_n_s ] [ +_oooo    _o_p_t_i_o_n _n_a_m_e ] ... [ +_AAAA [ _n_a_m_e ]    ] [ _a_r_g    ...
  898.            Set the options for the shell and/or set    the positional
  899.            parameters, or declare and set an array.     If the    -ssss
  900.            option is given it causes the specified arguments to be
  901.            sorted before assigning them to the positional
  902.            parameters (or to the array _n_a_m_e    if -AAAA is used).     With
  903.            +ssss sort arguments in descending order.  For the meaning
  904.            of the other flags, see the zzzzsssshhhhooooppppttttiiiioooonnnnssss man page.     Flags
  905.            may be specified    by name    using the -oooo option.  If the
  906.            -AAAA flag is specified, _n_a_m_e is set to an array
  907.            containing the given _a_r_gs; if +AAAA    is used    and _n_a_m_e is an
  908.            array, the gien arguments will replace the initial
  909.            elements    of that    array; if no _n_a_m_e is specified,    all
  910.            arrays are printed. Otherwise the positional parameters
  911.            are set.     If no arguments are given, then the names and
  912.            values of all parameters    are printed on the standard
  913.            output.    If the only argument is    +, the names of    all
  914.            parameters are printed.
  915.  
  916.       sssseeeettttoooopppptttt [ +__o_p_t_i_o_n_s ] [    _n_a_m_e ... ]
  917.            Set the options for the shell.  All options specified
  918.  
  919.  
  920.  
  921.      Page 14                         (printed 4/24/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  929.  
  930.  
  931.  
  932.            either with flags or by name are    set.  If no arguments
  933.            are supplied, the names of all options currently    set
  934.            are printed.  In    option names, case is insignificant,
  935.            and all underscore characters are ignored.  If the -mmmm
  936.            flag is given the arguments are taken as    patterns
  937.            (should be quoted to preserve them from being
  938.            interpreted as glob patterns) and all options with
  939.            names matching these patterns are set.
  940.  
  941.       sssshhhhiiiifffftttt    [ _n ] [    _n_a_m_e ... ]
  942.            The positional parameters from $_n+1111 ... are renamed $1111,
  943.            where _n is an arithmetic    expression that    defaults to 1.
  944.            If any _n_a_m_es are    given then the arrays with these names
  945.            are shifted instead of the positional parameters.
  946.  
  947.       ssssoooouuuurrrrcccceeee
  948.            Same as ...., except that the current directory is always
  949.            searched    and is always searched first, before
  950.            directories in ppppaaaatttthhhh.
  951.  
  952.       ssssuuuussssppppeeeennnndddd [ -ffff ]
  953.            Suspend the execution of    the shell (send    it a SSSSIIIIGGGGTTTTSSSSTTTTPPPP)
  954.            until it    receives a SSSSIIIIGGGGCCCCOOOONNNNTTTT.  If    the -ffff option is not
  955.            given, complain if this is a login shell.
  956.  
  957.       tttteeeesssstttt _a_r_g ...
  958.       [[[[ _a_r_g    ... ]]]]
  959.            Like the    system version of tttteeeesssstttt.     Added for
  960.            compatibility; use conditional expressions instead.
  961.  
  962.       ttttiiiimmmmeeeessss
  963.            Print the accumulated user and system times for the
  964.            shell and for processes run from    the shell.
  965.  
  966.       ttttrrrraaaapppp [ _a_r_g ] [ _s_i_g ] ...
  967.            _a_r_g is a    command    to be read and executed    when the shell
  968.            receives    _s_i_g.  Each _s_i_g can be given as a number    or as
  969.            the name    of a signal.  If _a_r_g is    -, then    all traps _s_i_g
  970.            are reset to their default values.  If _a_r_g is the null
  971.            string, then this signal    is ignored by the shell    and by
  972.            the commands it invokes.     If _s_i_g    is ZZZZEEEERRRRRRRR    then _a_r_g will
  973.            be executed after each command with a nonzero exit
  974.            status.    If _s_i_g is DDDDEEEEBBBBUUUUGGGG    then _a_r_g will be executed
  975.            after each command.  If _s_i_g is 0000    or EEEEXXXXIIIITTTT    and the    ttttrrrraaaapppp
  976.            statement is executed inside the    body of    a function,
  977.            then the    command    _a_r_g is executed    after the function
  978.            completes.  If _s_i_g is 0000 or EEEEXXXXIIIITTTT and the ttttrrrraaaapppp statement
  979.            is not executed inside the body of a function, then the
  980.            command _a_r_g is executed when the    shell terminates.  The
  981.            ttttrrrraaaapppp command with no arguments prints a list of
  982.            commands    associated with    each signal.
  983.  
  984.  
  985.  
  986.  
  987.      Page 15                         (printed 4/24/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  995.  
  996.  
  997.  
  998.       ttttrrrruuuueeee Do nothing and return an    exit code of 0.
  999.  
  1000.       ttttttttyyyyccccttttllll -ffffuuuu
  1001.            The -ffff option freezes the tty, and -uuuu unfreezes it.
  1002.            When the    tty is frozen, no changes made to the tty
  1003.            settings    by external programs will be honored by    the
  1004.            shell, except for changes in the    size of    the screen;
  1005.            the shell will simply reset the settings    to their
  1006.            previous    values as soon as each command exits or    is
  1007.            suspended.  Thus, ssssttttttttyyyy and similar programs have    no
  1008.            effect when the tty is frozen. Without options it
  1009.            reports whether the terminal is frozen or not.
  1010.  
  1011.       ttttyyyyppppeeee [ -ffffppppaaaammmm ] _n_a_m_e ...
  1012.            Same as wwwwhhhheeeennnncccceeee -vvvv.
  1013.  
  1014.       ttttyyyyppppeeeesssseeeetttt [ +_LLLLRRRRUUUUZZZZffffiiiillllrrrrttttuuuuxxxxmmmm [[[[_n]]]]]]]] [[[[ _n_a_m_e[[[[====_v_a_l_u_e]]]] ]]]]    ............
  1015.            Set attributes and values for shell parameters.    When
  1016.            invoked inside a    function a new parameter is created
  1017.            which will be unset when    the function completes.     The
  1018.            new parameter will not be exported unless ALLEXPORT is
  1019.            set, in which case the parameter    will be    exported
  1020.            provided    no parameter of    that name already exists.  The
  1021.            following attributes are    valid:
  1022.            -LLLL   Left justify and remove leading blanks from    _v_a_l_u_e.
  1023.             If _n is nonzero, it    defines    the width of the
  1024.             field; otherwise it    is determined by the width of
  1025.             the    value of the first assignment.    When the
  1026.             parameter is printed, it is    filled on the right
  1027.             with blanks    or truncated if    necessary to fit the
  1028.             field.  Leading zeros are removed if the -ZZZZ    flag
  1029.             is also set.
  1030.            -RRRR   Right justify and fill with    leading    blanks.     If _n
  1031.             is nonzero if defines the width of the field;
  1032.             otherwise it is determined by the width of the
  1033.             value of the first assignment.  When the parameter
  1034.             is printed,    the field is left filled with blanks
  1035.             or truncated from the end.
  1036.            -UUUU   For    arrays keep only the first element of each
  1037.             duplications. It can also be set for colon
  1038.             separated special parameters like PPPPAAAATTTTHHHH or FFFFIIIIGGGGNNNNOOOORRRREEEE,
  1039.             etc.
  1040.            -ZZZZ   Right justify and fill with    leading    zeros if the
  1041.             first non-blank character is a digit and the -LLLL
  1042.             flag has not been set.  If _n is nonzero it defines
  1043.             the    width of the field; otherwise it is determined
  1044.             by the width of the    value of the first assignment.
  1045.            -ffff   The    names refer to functions rather    than
  1046.             parameters.     No assignments    can be made, and the
  1047.             only other valid flags are -tttt and -uuuu.  The flag -tttt
  1048.             turns on execution tracing for this    function.  The
  1049.             flag -uuuu causes this    function to be marked for
  1050.  
  1051.  
  1052.  
  1053.      Page 16                         (printed 4/24/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  1061.  
  1062.  
  1063.  
  1064.             autoloading.  The ffffppppaaaatttthhhh parameter will be searched
  1065.             to find the    function definition when the function
  1066.             is first referenced; see aaaauuuuttttoooollllooooaaaadddd.
  1067.            -iiii   Use    an internal integer representation.  If    _n is
  1068.             nonzero it defines the output arithmetic base,
  1069.             otherwise it is determined by the first
  1070.             assignment.
  1071.            -llll   Convert to lower case.
  1072.            -rrrr   The    given _n_a_m_es are    marked readonly.
  1073.            -tttt   Tags the named parameters.    Tags have no special
  1074.             meaning to the shell.
  1075.            -uuuu   Convert to upper case.
  1076.            -xxxx   Mark for automatic export to the environment of
  1077.             subsequently executed commands.
  1078.            Using + rather than - causes these flags    to be turned off.
  1079.            If no arguments are given but flags are specified, a
  1080.            list of named parameters    which have these flags set is
  1081.            printed.     Using + instead of - keeps their values from
  1082.            being printed.  If no arguments or options are given,
  1083.            the names and attributes    of all parameters are printed.
  1084.            If only the -mmmm flag is given the    arguments are taken as
  1085.            patterns    (should    be quoted) and all parameters or
  1086.            functions (with the -ffff flag) with matching names    are
  1087.            printed.
  1088.  
  1089.       uuuulllliiiimmmmiiiitttt [ -SSSSHHHHaaaaccccddddffffllllmmmmnnnnppppssssttttvvvv ] [ _l_i_m_i_t ] ...
  1090.            Set or display resource limits of the shell and the
  1091.            processes started by the    shell.    The value of _l_i_m_i_t can
  1092.            be a number in the unit specified below or the value
  1093.            uuuunnnnlllliiiimmmmiiiitttteeeedddd.  If the -HHHH flag is given use hard limits
  1094.            instead of soft limits.    If the -SSSS flag is given
  1095.            together    with the -HHHH flag set both hard and soft
  1096.            limits.    If no options are used,    the file size limit
  1097.            (-ffff) is assumed.     If _l_i_m_i_t is omitted the current value
  1098.            of the specified    resources are printed.    When more than
  1099.            one resource values are printed the limit name and unit
  1100.            is printed before each value.
  1101.            -aaaa   Lists all of the current resource limits.
  1102.            -cccc   The    number of 512-byte blocks on the size of core
  1103.             dumps.
  1104.            -dddd   The    number of K-bytes on the size of the data
  1105.             segment.
  1106.            -ffff   The    number of 512-byte blocks on the size of files
  1107.             written.
  1108.            -llll   The    number of K-bytes on the size of locked-in
  1109.             memory.
  1110.            -mmmm   The    number of K-bytes on the size of physical
  1111.             memory.
  1112.            -nnnn   The    number of open file descriptors.
  1113.            -ssss   The    number of K-bytes on the size of the stack.
  1114.            -tttt   The    number of CPU seconds to be used.
  1115.            -uuuu   The    number of processes available to the user.
  1116.  
  1117.  
  1118.  
  1119.      Page 17                         (printed 4/24/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  1127.  
  1128.  
  1129.  
  1130.            -vvvv   The    number of K-bytes on the size of virtual
  1131.             memory.
  1132.  
  1133.       uuuummmmaaaasssskkkk    [ -SSSS ] [ _m_a_s_k ]
  1134.            The umask is set    to _m_a_s_k.  _m_a_s_k can be either an    octal
  1135.            number or a symbolic value as described in cccchhhhmmmmoooodddd(1).
  1136.            If _m_a_s_k is omitted, the current value is    printed.  The
  1137.            -SSSS option causes    the mask to be printed as a symbolic
  1138.            value.  Otherwise, the mask is printed as an octal
  1139.            number.    Note that in the symbolic form the permissions
  1140.            you specify are those which are to be allowed (not
  1141.            denied) to the users specified.
  1142.  
  1143.       uuuunnnnaaaalllliiiiaaaassss [ -mmmm ] _n_a_m_e ...
  1144.            The alias definition, if    any, for each _n_a_m_e is removed.
  1145.            With the    -mmmm flag    the arguments are taken    as patterns
  1146.            (should be quoted) and all aliases with names matching
  1147.            the patterns are    removed.  uuuunnnnaaaalllliiiiaaaassss is equivalent    to
  1148.            uuuunnnnhhhhaaaasssshhhh ----aaaa.
  1149.  
  1150.       uuuunnnnffffuuuunnnnccccttttiiiioooonnnn [ -mmmm ] _n_a_m_e ...
  1151.            The function definition,    if any,    for each _n_a_m_e is
  1152.            removed.     If the    -mmmm flag    is specified the arguments are
  1153.            taken as    patterns (should be quoted) and    all functions
  1154.            with names matching the patterns    are removed.
  1155.            uuuunnnnffffuuuunnnnccccttttiiiioooonnnn is equivalent    to uuuunnnnhhhhaaaasssshhhh ----ffff.
  1156.  
  1157.       uuuunnnnhhhhaaaasssshhhh [ -aaaaddddffffmmmm ] _n_a_m_e    ...
  1158.            Remove the element named    _n_a_m_e from an internal hash
  1159.            table.  The default is remove elements from the command
  1160.            hash table.  The    -aaaa option causes uuuunnnnhhhhaaaasssshhhh    to remove
  1161.            aliases.     The -ffff    option causes uuuunnnnhhhhaaaasssshhhh to    remove shell
  1162.            functions.  The -dddd options causes uuuunnnnhhhhaaaasssshhhh    to remove
  1163.            named directories.  If the -mmmm flag is given the
  1164.            arguments are taken as patterns (should be quoted) and
  1165.            all elements of the corresponding hash table with
  1166.            matching    names will be removed.
  1167.  
  1168.       uuuunnnnlllliiiimmmmiiiitttt [ -hhhhssss    ] _r_e_s_o_u_r_c_e ...
  1169.            The resource limit for each _r_e_s_o_u_r_c_e is set to the hard
  1170.            limit.  If the -hhhh flag is given and the shell is
  1171.            running as root,    the hard resource limit    for each
  1172.            _r_e_s_o_u_r_c_e    is removed.  The resources of the shell
  1173.            process are only    changed    if the -ssss flag is given.
  1174.  
  1175.       uuuunnnnsssseeeetttt    [ -ffffmmmm ]    _n_a_m_e ...
  1176.            Each named parameter is unset. If the -mmmm    flag is
  1177.            specified the arguments are taken as patterns (should
  1178.            be quoted) and all parameters with matching names are
  1179.            unset.  UUUUnnnnsssseeeetttt -ffff    is equivalent to uuuunnnnffffuuuunnnnccccttttiiiioooonnnn.
  1180.  
  1181.       uuuunnnnsssseeeettttoooopppptttt [ +__o_p_t_i_o_n_s ]    [ _n_a_m_e ... ]
  1182.  
  1183.  
  1184.  
  1185.      Page 18                         (printed 4/24/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))   zzzzsssshhhh vvvveeeerrrrssssiiiioooonnnn 3333....0000 ((((JJJJuuuunnnneeee 22226666,,,,    1111999999996666))))    ZZZZSSSSHHHHBBBBUUUUIIIILLLLTTTTIIIINNNNSSSS((((1111))))
  1193.  
  1194.  
  1195.  
  1196.            Unset the options for the shell.     All options specified
  1197.            either with flags or by name are    unset. If the -mmmm flag
  1198.            is given    the arguments are considered to    be patterns
  1199.            (don't forget to    quote them) and    all options with names
  1200.            matching    these patterns are unset.
  1201.  
  1202.       vvvvaaaarrrreeeedddd    [ -cccc ] [ -hhhh ] [    -pppp _p_r_o_m_p_t ] [ -rrrr _r_p_r_o_m_p_t ] _n_a_m_e
  1203.            The value of the    parameter _n_a_m_e is loaded into the edit
  1204.            buffer, and the line editor is invoked.    When the
  1205.            editor exits, _n_a_m_e is set to the    string value returned
  1206.            by the editor.  If the -cccc flag is given the parameter
  1207.            is created if it    doesn't    already    exist.    If the -pppp flag
  1208.            is given    the following string will be taken as the
  1209.            prompt to display at the    left and if the    -rrrr flag    is
  1210.            given the following string gives    the prompt to display
  1211.            at the right.  If the -hhhh    flag is    specified, the history
  1212.            can be accessed from zle.
  1213.  
  1214.       wwwwaaaaiiiitttt [ _j_o_b ... ]
  1215.            Wait for    the specified jobs or processes.  If _j_o_b is
  1216.            not given then all currently active child processes are
  1217.            waited for.  Each _j_o_b can be either a job specification
  1218.            or the process-id of a job in the job table.  The exit
  1219.            status from this    command    is that    of the job waited for.
  1220.  
  1221.       wwwwhhhheeeennnncccceeee [ -vvvvccccffffppppaaaammmm ] _n_a_m_e ...
  1222.            For each    name, indicate how it would be interpreted if
  1223.            used as a command name.    The -vvvv flag produces a more
  1224.            verbose report.    The -cccc flag prints the results in a
  1225.            csh-like    format,    and takes precedence over -vvvv.  The -ffff
  1226.            flag causes the contents    of a shell function to be
  1227.            displayed, which    would otherwise    not happen unless the
  1228.            -cccc flag were used.  The -pppp flag does a path search for
  1229.            _n_a_m_e even if it is an alias, reserved word, shell
  1230.            function    or builtin.  The -aaaa flag does a    search for all
  1231.            occurrences of _n_a_m_e throughout the command path.     With
  1232.            the -mmmm flag the arguments are taken as patterns (should
  1233.            be quoted) and the information is displayed for each
  1234.            command matching    one of these patterns.
  1235.  
  1236.       wwwwhhhheeeerrrreeee
  1237.            Same as wwwwhhhheeeennnncccceeee ----ccccaaaa.
  1238.  
  1239.       wwwwhhhhiiiicccchhhh    [ -ppppaaaammmm ] _n_a_m_e ...
  1240.            Same as wwwwhhhheeeennnncccceeee ----cccc.
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.      Page 19                         (printed 4/24/98)
  1252.  
  1253.  
  1254.  
  1255.